home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / debugtx.arc / 00READ.DOC next >
Encoding:
Text File  |  1991-08-11  |  7.0 KB  |  175 lines
  1.                                                              0-1
  2.  
  3. D86 debugger package   V3.09           August 13, 1987
  4. The entire package is Copyright (C)1986-1987 Eric Isaacson.
  5. All rights reserved.
  6.  
  7. For easier bulletin-board distribution, I have split this package 
  8. into two ARC files, D86V309A.ARC and D86V309B.ARC. The first file 
  9. contains enough to get you started; you can evaluate the package 
  10. and then download the second file later on.  
  11.  
  12. PLEASE read Chapter 1 for legal terms and conditions, how to 
  13. register for the package, and an overview of the debugger.
  14.  
  15.  
  16. QUESTION: "I bought this debugger from XYZ Software House, that 
  17.   advertised great software for $5 per disk.  What's going on 
  18.   here?  Have I already bought an debugger, or what?" 
  19.  
  20. ANSWER: Well, no, not exactly.  You've bought a disk that has 
  21.   great software on it; you haven't bought the software yet.  
  22.   D86, like the vast majority of software offered by the $5-per-
  23.   disk distribution houses, is free-distribution software (also 
  24.   known as "shareware", or "user-supported software").  That 
  25.   means I retain the right to D86, but I choose to let people 
  26.   pass it around.  I have no business relationship with any 
  27.   distribution houses in America; I don't get a penny of the $5 
  28.   (or whatever) you paid them for the disk containing A86.  So I 
  29.   need and expect to be paid by you, because I'm trying to make a 
  30.   living out of making and supporting shareware products. 
  31.  
  32.   Many distribution houses do a pretty poor job of revealing the 
  33.   shareware nature of the software they sell.  If you thought you 
  34.   had purchased the software free and clear, you might feel 
  35.   justified in being angry with them for having misled you.  And 
  36.   you might look around for houses that do a better job of 
  37.   informing the public.  But I hope you'll take the time to 
  38.   consider everybody's role in the shareware marketing scene; if 
  39.   you do, I think you'll conclude that although you may have 
  40.   been misled, you haven't really been cheated out of anything. 
  41.  
  42.   Shareware is great for authors like me, who have spent all 
  43.   their years in their computer holes, learning to be great 
  44.   programmers, and no time in business school learning marketing 
  45.   and distribution techniques.  We simply cast our programs to 
  46.   the winds.  They are distributed at practically no cost to 
  47.   us.  That's why we can charge a lot less than the cost of 
  48.   "commercial" software. 
  49.  
  50.   Shareware is also great for customers like you.  You can try 
  51.   out the software before paying for it.  You'll know that a 
  52.   successful shareware product is good, because only satisfied 
  53.   customers pay for it.  The existence of shareware infuses 
  54.   healthy competition in the entire software market, for both 
  55.   price and quality.  In the case of D86, I'm utterly convinced 
  56.   that you'll never find a better value for an debugger, 
  57.   anywhere.
  58.                                                              0-2
  59.   Finally, let's consider the distribution houses.  They provide 
  60.   a legitimate service, for which they charge a reasonable price.  
  61.   The best houses act as librarians, evaluating and cataloguing 
  62.   software.  Most pay thousands of dollars for advertising.  
  63.   Their cut is far less than the distributor's cut for 
  64.   "commercial" software (they prosper because their volume is 
  65.   bigger).  Most customers for the distribution houses are repeat 
  66.   customers, who are aware of, and happy with, what they are 
  67.   getting.  If it weren't for your XYZ House, you might never 
  68.   have heard of A86, or might never have figured out where to 
  69.   obtain it. 
  70.  
  71.   So I hope you'll be happy with shareware, and actively desire 
  72.   to support it.  You'll feel good about promoting a healthy 
  73.   situation for everybody.  And you'll encourage the best 
  74.   programmers in the world to keep writing for you, instead of 
  75.   for the big corporations.
  76.  
  77. Now that I've said that, let's move on to the package.   The D86 
  78. package consists of the two programs D86.COM and A86.COM; a 
  79. collection of source and batch files used by the demonstration 
  80. in Chapter 2 and instructions in Chapter 3, and a sequence of DOC 
  81. files that, when printed out in order, make the manual.  Each 
  82. chapter is a DOC file whose name starts with 2 digits indicating 
  83. the chapter number.  The files are: 
  84.  
  85. 00READ.DOC    (this file)      07FLOAT.DOC
  86. 01INTROD.DOC                   08QUEST.DOC
  87. 02DEM.DOC                      09HIST.DOC
  88. 03REQ.DOC                      10INDEX.DOC
  89. 04CONTRL.DOC
  90. 05COMMAN.DOC
  91. 06MEMORY.DOC
  92.                                                              0-3
  93. TABLE OF CONTENTS
  94.  
  95.  
  96. CHAPTER 1   INTRODUCTION AND LEGAL TERMS
  97.  
  98. Introduction                       1-1
  99. Legal Terms and Conditions         1-1
  100. Overview of D86                    1-3
  101. Who IS That Guy?                   1-4
  102. Support Your Local Bulletin Board  1-4
  103. How to Get in Touch With Me        1-5
  104.  
  105.  
  106. CHAPTER 2   D86 DEMONSTRATION
  107.  
  108.  
  109. CHAPTER 3   REQUIREMENTS AND OPERATION
  110.  
  111. System Requirements for D86                      3-1
  112. Invoking D86                                     3-1
  113. Finding the Program File                         3-1
  114. Finding the Symbols File                         3-2
  115. Two-Screen Debugging with +V                     3-3
  116. The D86 Screen Display                           3-3
  117. D86 Commands                                     3-4
  118. Immediate Assembly-Language Commands             3-4
  119. Entering Instructions Into Memory                3-5
  120. Entering Data into 8086 Memory                   3-5
  121. Adding Symbols to a Program                      3-6
  122. What to Do if D86 Doesn't Work on Your Computer  3-6
  123. If You'd Like to Be Ambitious                    3-7
  124. Keyboard Mapping Chart                           3-8
  125.  
  126.  
  127. CHAPTER 4    D86 CONTROL KEYS
  128.  
  129. Display Control Keys                          4-1
  130. Instruction Pointer Positioning Control Keys  4-2
  131. Program Execution Control Keys                4-4
  132. Special Action Control Keys                   4-4
  133.  
  134.  
  135. CHAPTER 5   COMMAND LANGUAGE
  136. General Operands to Debugger Commands    5-1
  137. Format of Debugger Command Examples      5-1
  138. The Debugger Command Set                 5-1
  139.                                                              0-4
  140.  
  141. CHAPTER 6   MEMORY DISPLAY OPTIONS
  142.  
  143. Memory Display Windows                  6-1
  144. Single-Line Memory Windows              6-1
  145. Erasing Memory Display Lines            6-2
  146. Continuation Lines                      6-3
  147. Mixed Format Specification              6-3
  148. Numbers in a Format Specification       6-3
  149. Spacing Between Memory-Display Units    6-4
  150. Special-Action Format Specifiers        6-4
  151. The Data Memory Window                  6-8
  152.  
  153.  
  154. CHAPTER 7    FLOATING POINT DEBUGGING
  155.  
  156. The Floating-Point Display Window          7-1
  157. Exotic Flavors of Floating-Point Numbers   7-3
  158.  
  159.  
  160. CHAPTER 8   COMMONLY ASKED QUESTIONS
  161.  
  162. Setting Registers        8-1
  163. Modifying Memory         8-1
  164. Screen Problems          8-2
  165. Debugging ROM            8-3
  166.  
  167.  
  168. CHAPTER 9    RELEASE HISTORY AND FUTURE PLANS
  169.  
  170. Release History of D86       9-1
  171. Future Plans                 9-2
  172.  
  173.  
  174.  
  175.